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‘, FILE HANDLING SYSTEM 


DRAFT MICRODRIVE, LAN and RS232 SOFTWARE DOCURENTATION 


M.d. BRENNAN : 
20/4/83 
KICRODRIVE 
EEESEERLER 
‘The aicrodrive records data on two tracks of an endless a i"? = 


loop of video quality tape. The tape isdetfinch width anc 200 inches 


long. The tepe travels at a noswinal speed of 30 inches per second 
with a variztion of +/- 10%. 
The data is recorded on the taps at a density of 100,000 bits 
per second per track. This gives the capsule an unforgatted capacity 
of 162K, The recording forsat is FH. There is one fiux transition every 
bit cell (19u5) and one in the aiddle of the cell if the bit is a one. 
Because of the splice certain regions of the tape cannot be used. 
There is no harware geans of detersining the position of the tape in the 
loop. 
The record/replay head has a built in erase gap which erases / 
both tracks; the erase gap leads the replay gap by {.6aa. | 
The data on the two tracks is seen as one streaa of bytes 
because the controller chip records succesive bytes on alternate 
tracks. 
Each sicrodrive contains electronics to select the sicrodrive, 


provide the write and erase currenis,asplify, filter and square the 
output fron the head. The sstor is turned-cn only when a wicrodrive 
is selected, only one sicrodrive aay be selected at a tise. 

The interface contains logic to aodulate/deaodulate 
serialize/ceserialize the data fros the gicrodrive. It also contains 
the sicrodrive, LAN, and R5232 software in an 8K ROM. 

Data is recorded in sectors. Each sector contains 512 data 
bytes plus other file handling inforaation. & sector has the fallowing 
structure:- , : 

Header block contains 10 byte capsule nage =: 1.1285 
sector nuzber ‘ 
checksua : 
Gap 1 3.208 © - 3- 
Data block contains 10 byte filenase 21,285 
record nusber 
byte count 
y+ flag byte 
checksua 


512 bytes of data 
data checksua 


Bap 2 , : 6.185 


oeeeen~ 


TOTAL . . 31.6225 


This gives a noainal content of 210 sectors with an upper liait of 230 
sectors per capsule. 

Not all the sectors are good for recording: the good sectors 
are identified during FORMATing. 

The capsule has a write pretect tab like a ausic or video cassette 
this is not a hardware write protect but it is detected by the software. 
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Nicrodrive files are recorded in blocks of 542 bytes called 
records, The records are recorded into the first encountered free 
sector on the tape and the sector is sarked "not free” in the MAP. 

The data in a record is accospanied by the record nuaber, 
byte count, filenage and a flag. 

The byte count is usually 512 but aay be less if it is the 
last record in a file: in which case a bit is set in the flag byte. 

There are two types of file used by BASIC. One type is used 
by PRINT, INPUT and MOVE and would normally be readable, the other 
type is used by SAVE, LOAD, VERIFY and MERGE and would nat noraally 
be readable. These are distinguished by a bit in the flag byte. 

When a file is cpened in BASIC there is no way of specifying 
whether the file is opened for input or output so the tape is searched 
until either a record of the file is found, in which case the file is 
opened for input or if no record is found the file is opened for 
output. 


The file handling systea does not use a directory for two reasons:~ 


1) The space consused by « directory { 
2) You ‘still have to read the sectors sequentially | 
to find a record. - 


The are a nuaber of drawbacks with this approach:- 


1) lf a file is opened for writing, the entire tape 

aust be searched to ensure that the file doesn’t : it 
- already exist and to sake a RAP of the free sectors ; 

2) When doing a catalogue of a capsules contents oO 
or opening a file it is possible that a file isn’t . 
read properly first tise. If this is the only record 
in a given file then it will be ossitted froa the 
catalogue or worse it will be opened for write rather 
than read. This situation is increasingly unlikely 7 
if the file consists of acre than one record. - 


This file handling systea is adequate for the sequential nature 
of the existing BASIC INPUT/PRINT cogmands and for the sequential 
nature of the aedius. It is likely to prove inadequate for 
applications requiring randoa access. 
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It is intended that these applications (assused to be aachine code) 
will use procedures froa the RON ta overcoge the drawbacks of the 
software as viewed froa BASIC. Any higher level file handling 
would still be cospatible with the BASIC syste. 


The following data itess are used by the sicrodrive 
softwares- 


MICRODRIVE BUFFER 


Every tiae a file is opened an area called a CHANNEL is 
treated in the area designated CHANS in the BASIC reference anual. 
This area is usually addressed by the IX register in the software. 
The channel has a length of 595 bytes. 

The contents of the CHANNEL are as follows:- 


address 9 

address 8 

7H? 

address of output subroutine in ROW 
address of input routine in ROM 


SP 


» YY e® » 8 Ff FF 8 FY fF F&C F&F F&F F&F F&F F&F Fe F&F & F 
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ga q adaress o7y 
1 . CHBYTE current byte counter indicates the next byte 
: to be added or reaoved froa the data area 
[2] in the range 0-512 inclusive. 
13 CHREC. record nusber. indicates the position of the 
record in a file range 0-255 
B 14 CHHANE 10 byte filenaae with trailing spaces 
24 CHFLAS flag byte bit 0 set...open for write 
tlear.open for read 
Bg . bits 1-7....unused 
25 CHDRIY drive nusher 1-8 
26 CHHAP «=o address of the MAP for this aicrodrive 
i) 28 12 bytes of header preasble....aarks the 
start of the header workspace 
40 HDFLAG flag byte bit 0 set 


oy 


Ss bits 1-7....unused 

4i HDNUKB sector nuaber in range 0-255 

42 unused 
is] 44 HDNAKE capsule nawe and trailing spaces 

a4 HDCHK «=oheader checksua 

35 12 bytes of data block preasble...marks 
B the start of the data workspace 


87 RECFLG flag byte bit 0=0 
bit l=last record in file 
9 , bit 2=not a PRINT file 
bits 3-7 unused 
68 | RECNUA usher of this record in the range 0-255 
Q 69 RECLEN nuaber of bytes of data in this record 0-512 
71 RECNAN filenage with trailing spaces 
B81 . DESCHK checksua of the preceding 14 bytes 
e «BR CHDATA 12 bytes of data 
594 DCHK = checksua of the preceding 512 bytes 


) When a record is written to the tape the area froa RECFLE to 
BCHK is recorded in a data block. This data is retrieved when the record 
is read. 

re) i , 
RAP 

NG \ 

ta) ‘. For every aicrodrive containing an opened file there is 


an area called a KAP created in the area called “wicradrive saps* 
in the BASIC reference sanual. This area now starts at address 
‘2 23791. A RAP contzins 32 bytes. Each bit corresponds to a sector 
on the corresponding microdrive. If that sector contains data or if 
it is unuseabie then the bit is set. The bits are nuabered as follows: 
Fe) bit 0 byte 0 = sector 0, bit 1 byte 0 = sector 1, bit 0 byte 1 = 
sector 8 and 50 on. © 


r=] THE RETHORK 
EELEELELELS 
8 The network allows for the linking of 2-64 SPECTRUM coaputers, 


The linkage between coaputers is a two wire systes..signal wire and 
ground wire. 


is] ; 
Each SPECTRUM constitutes a station and by using the 
FORMAT "n"3x coagand it is possible to assign the required station 
8 nuaber (x) to a given coaputer. The range of station nuabers is 1-44 
Data is transaitted and received on the network in ppaRtENs 
a The transait process is as follows:- 


i} Wait for the network to be free for between 2-3a5 72277 


6 @ © 9 @ @ @ 
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2), ‘Try to claia the network by sending a "scout" signal. 


Check that there is no contention. Repeat from 1) if 
there is a collision. 


-) Send out a *header® coaprising 8 bytes of data fa copy of 


bytes 11-18 in the network channel area). 


4) Wait for an acknowl egesent. Repeat from 1) if nothing found 


5) Send out the data block coaprising 1-255 bytes of data 
(a copy of the data buffer) 


4) Wait for an acknowledgesent. Repeat from 1) if nothing is found 


- The receive process is as follows:- 


1} Hait for the network to be free for at least 285. 
2) Wait for the network to becose active ("scout"). 


3) Collect the "header® block coapute the checksua 
and acknowledge if it is correct. Repeat fro 1) if not. 
It is correct if it has the correct source and destination 
station nuabers and has the correct sequence nuaber. 


4) Collect the data block coapute the checksus and acknowledge 
if correct. Repeat fros 1) if not. 


Hessages say be BROADCAST to sore than one station. The protocol 
is as above but no AEE HEWTEOURERTE are required. The receiver aust be 
expecting a broadcast. 


A "scout" and "header® pair take about 1.4285 and are repeated 
about once every 89 if not acknowledged. 

& "scout","header” and data block containing 255 bytes take about 
3725. ; 

Stations wait a randoa interval after the network has becose 
free before transeitting packets. This scheae avoids tise consuaing 
collisions. 


RETRORK CHANREL 


Bhen a streas is opened to the network a channel is created 
in the area designated CHANS in the BASIC reference aanual. : 
This area is usually addressed by the IY register in the software. 
The channel has a length of 276 bytes 


The contents of the channel are described as followss- ; : 
0 address 8 
2 address 8 
4 “HN? 
3 address of output subroutine in ROW 
7 address of input subroutine in RON 
9 address 276 
il HCIRIS the destination station nusber 


12 NCSELF this SFECTRUNs station nuaber 

13 NCHUMB the block nusber 

15 NCTYPE the packet type code...0 data, 1 EOF. 
16 NCGBL = nueber of bytes in the data block 


Treen 


Fe) J?) | REBCS = the data checksua 
“+ AB JNCHES = the header checksue 
19 HCBL —sthe position of the last character taken froa the buffer 


& 29 KCB the nuaber of bytes in the input buffer 
rat a 255 byte data buffer. 
i) Texporary network channels are created and deleted afterwards 


during SAVE,LOAD, VERIFY and MERGE coagands. They aay also be created from — 
aachine code. 


>] 
SYSTEM VARIABLES 
g : ~ 
The sicrodrive, LAN and RS232 software uses aore systes 
variables; these are described as follows:- 
% 
23734 FLAGS3 «Flags 
23735 «VECTOR «Address used to extend the BASIC interpreter 
8 23737) SBRT) «= ROA paging subroutine 
23747) BAUD = Two byte nuaber deteraining the baud rate ; 
calculated a5 follows:- / 
re) BAUD=(3500000/ (26tbaud rate))-2 { 
23749 ONTSTAT Gun network station nuaber 1-64 , \ ; 
23750 «=LOBORD Border colour used during 1/0 ; i 
2 23751 SER_FL 2 byte workspace used by R5232 7 ea 
23753 SECTOR 2 byte workspace used by sicrodrive \ \ 
23755 CHADD_ Tesporary store for CH ADD \ ~ 
g 23757 NTRESP Store for network response code mT 
23758 NTDEST Beginning of network buffer . 
a contains destination station nuaber 0-d4 
re] 23759 «= NTSRCE «source station nuaber 1-64 
23700 RTRURB network block nuaber 0-85535 
23762) sWITYPE heager type code 
3 23783 NTLEN data block length 0-255 
23764 NTDCS data block checksua : 
23765 NTHCS header block checksua ~ 
=) 23766 D_STRI start of 8 byte file specifier 
2 byte drive nuaber 1-8 
23768 «=S_STRL streas nusber 1-15 
g 23767 =L_STRL device type... "H*,"H","T" or "B* 
23770 N_STRI length of filenase ~ 
23772 start of filenase 
s 23774 D_STR2 second 8 byte file specifier 


used by ROVE and LOAD cosaands 
23782 «=HD_OG = start of workspace for SAVE,LOAD, VERIFY 
ts) and HERGE. ; 
data type code 


23783 HD_OB length of data 0-45535 
8 23785 HD_OD start of data 0-65535 ; 
23787 =HD_OF = prograa length 0-65535 : 
23769 «= HD_11))s Line nuaber : 
& : 
23791 «COPIES nuaber of copies of prograa to be saved by SAVE coaaand - 
3 23772) Start of sicrodrive MAPS or CHANS - ; = 
PROCEDURES 
6 
To gake the job of writing application software easier 
procedures in the new ROM have been sade available. These are called 
] with the following two byte call:- 


RST 8 
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“where Nis the code for a particular procedure. 


The procedures, their codes and parameters are described 
below. All registers are corrupted. 

If the procedure cannot coaplete the request or if it is 
interupted (if the break key is pressed) it sakes an error return. 
This seans that it loads SP frow ERR_SP and returns. This allows the — 
caller to handle errors, 

The reader should note that the new systea variables should be 
created before they can be set up prior to calling any procedure. This is 
achieved by calling procedure code 49 first. 

Register IY should point into the systea variables at SC3Ah 
when any of the procedures are called. 


CONSOLE INPUT code 27 
SEEELESELEELE 


This procedure waits for a character to be typed in on the 
SPECTRUM keyboard and returns it in the A register. Nothing is printed 
on the screen. ; 


CONSOLE OUTPUT code 23 
ESELERELEELEESE 


This procedure prints the character in the A register in 
the upper part of the screen. ‘ 


RS232 INPUT code 29 
EELELEEEETE 


This procedure waits for a character received on the RS232 
serial interface. The baud rate is specified by BAUD in the systes 
variables the forast is § data bits, 1 stop bit. No frasing 
error is generated if the stop bit is sissing. The byte is returned 
in register A. 


RS232 QUIPUT = code 30 
EESELEELATES 


This procedure cutputs the byte in A onto the 83222 serial 
interface. The baud rate is specified by BAUD in the systea 
variables, The transaission foreat is § data bits, 2 stop bits, no parity. 


7X PRINTER OUTPUT code 3i 


FEELELELELELILELE 


. 


This procedure outputs the byte in A to the 2k printer 


KEYBOARD TEST code 32 
FEEEEELELELEE 


This procedure tests to see if a key has been pressed. 
The carry flag is set if a character is available. 


SELECT DRIVE code 33 
EEEEEELLETEE 


Me 


This procedure selects the drive specified in A, range 1-8, 
The sotor is started in the selected drive and interupts are disabled 
If A-0 then all drives are de-selected, all the sotors are turned off 
and interunts are enabled, 

If no signal is found froa the selected drive then all 


craves are Ce-S&iected and an error return is sade, 


” .This usually happens if the drive doesn’t contain a foreatted 


capsule or if the érive is not present. 


OPEN FILE code 34 
ELELEELIE : 


This procedure creates a channel in CHANS and a BAP (if 
necessary? below CHANS pushing up everything in eesory up to 
STREND, 

The file is specified as follows:- 
the drive nusber is stored in D_STRI 
the length of the filenaae is stored in h_STRI 
the address of the filenase is stored in N_STR é 

The drive is then selected and searched for the specifie 
file. If the file exists then the first record is read into the buffer 
and bit 0 of CHFLAG is cleared (to indicate that it has been opened 
for read). If the file does not exist the MAP is sarked to show the 
location of all free sectors and bit 0 of CHFLAS is set (to indicate that 
the file has been opened for write). 


Open only works for PRINT/INPUT type files en error return ( 
is gade if an attespt is eade to open a SAVE type file. =. | 
If the file exists but the first record cannot be found 
ah error return is sade, \ 

As wany files aay be opened as aemory allows. MAPs are ; 

Only one HAP is created per drive and this say Shared between \ 
Bany opened files. 

A file say be opened for read gore than once but day only 
be opened of write once. An error return is eade if an atteapt is 
fade to open a file previously opened for write, 

The address of the channel is returned in I%. 


CLOSE FILE code 35 
FELEEEELEL 


This procedure closes the file whose channel is identified 
by IX. If the file was opened for read the channel and RAP (if necessary) 
are deleted and the rest of sesory up to STKEND is dropped down. 

If the file was opened for write the current record is 
as the end of file and it is written onto the first free sector 
of the gicrodrive. The channel and MAP are deleted as for a read 
file. 

An error return is sade if there is no roca on the sicrodrive 
for the last record, 


DELETE FILE code 36 
ELELEEEELES 


This procedure erases a file Specified as in OPEN. 
A channel and KAP {if necessary) are teaporarilly created and deleted 
while this is taking place. 


READ SEQUENTIAL code 37 
FEELELRELEESTEE 


This procedure reads the next record in the file whose channel 
is identified by IX. The nuaber in CHREC is increaented, 

An error return is sade if an atteapt is sade to read past 
the end of file or if a record cannot be found, 

T¥ an atteapt is sade to read a record cf an SAVE type 
file the channel is deleted and an error return is sade, 


""" , WRETESRECORD = code 38 
ELELEEEEREEE 


This procedure writes the record in the file whose channel 
is identified by IX onto the next free sector on the drive. 
e% A free sector is one containing a block which contains fewer 
than 512 bytes and is not aarked end of file. 
CHREC is not increaented. An error return is sade if there is no 
ty free space on the drive. : 


READ RAXDOW code 39 
4 EEEELELLELE 


This procedure reads the record specified by CHREC in the 


oa channe] identified by 1X. : 
lf an atteapt is sade to read a record of an SAVE type 
file the channel is deleted and an error return is sade, 


READ SECTOR code 40 
EEELELELLEEE 


This procedure reads the data block in the sector identified 
by CHREC into the channel identified by 1X. 
eS The carry flag is set it the data is erroneous. 
The data in the buffer will be sade void if it contains data belonging 
to a SAVE type file. 


a) The drive should previously be selected. An error return is sade 
if a sector is not found within one revolution. : 

& READ KEXT code 41 
EREEEEELE , 

& This procedure reads the data block in the next sector found 


into the sicrodrive channel specified by IX. This can be a convenient way 
of finding where the tape is. The nuaber of the header will be found 
& in the channel at HDHUNR. The carry flag is set if the data is erroneous. 
ee The data in the buffer will be aade void if it contains data belonging 
to a SAVE type file. 
£3 The drive should previously be selected. fn error return is 
gade if a sector cannot be found within one revolution. 


* 
S BRITE SECTOR code 42 j 
EEESELEEPELE 
Ss This procedure writes the data block in the channel specified 
by IX into the sector identified by CHREC. 
; The drive should previously be selected. An error return is 
@ sade if the drive is write protected or of the sector cannot be found. 
The MAP is aarked to indicate that the sector is occupied. 
& CREATE SUFFER code 43 
EELELELULEELE 
oe] This procedure creates a aicrodrive channel -in CHANS and a HAP 
(if necessary) below CHANS pushing up ‘everything in seaory up to STKEXD, 
The drive and filenaae are specified as in the GFEN procedure 
3 ;code 34. The address of the channel is returned in IX. 
DELETE BUFFER code 44 
& EEEELEELEEEHE 


This procedure deletes the channel identified by IX 
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'. fe DECN-HETHORK CHANNEL code 45 


PEELELELES TELE REEL EE 


This procedure opens a network channel to the station 
whose nusber is stored in D_STR1, our current station nuater should 
be stored in HTSTAT. 

A network area is created in CHANS; everything else in 
geeory up to STKEND is pushed up. The address of the channel 
is returned in IX. . 


CLOSE RETHORK CHANNEL code 44 
ESEELLESEREEEEEEEELEE , 


This procedure closes the network channel specified by 1%. 
If the buffer contains data yet to be sent (NCOBL > 0). then this is 
sent in a final packet before the channel is deleted. 


BET PACKET code 47 
FEEELELYEE 


This procedure gets the next packet for the network channel 
identified by IX. NCNUAB identifies the required block nuaber. 
iBoth this block and the previous one will be acknowledged in case 
bur acenculedgsent to the last block was last). 

The procedure returns within 1288 if there is no packet 
available. If an approsriate packet arrives the procedure say take 
a further 3735. 

lf the procedure is waiting for a broadcast {NCIRIS = 0) then 
it dces not return until a sacket is received. 

The carry flag is set if no packet is available or if the 
received packet was erronecus in sose way. 

The packet “header” and data block can be found in the 
channel starting at HCIRIS and NCB respectively. 

HCHUMB is increaented. 


SERD PACKET code 48 
EREEELELILE ae 


This procedure sends a packet froa the network channel 
identified by IX. The nuaber of bytes in the data buffer is specified 
by RCOBL (aust be > 0), The byte in A is stored in NCTYPE. NCNUHB is 
incresented, The procedure does not return until the packet has been sent 
and an acknowledgeent received (no acknowledgaent is necessary in the 
case of a BROADCAST; ie NTDEST=0). 


CREATE SYSTEM VARIABLES code 49 
HEEEEEELELEERELEREEELES 


This procedure creates a space for and initializes the new 
systea variables described above. This should be called before attespting 
to set up any any of these variables prior to calling any of the above 
procedures. : 


